home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / c / cdecl-2.000 / cdecl-2 / cdecl-2.5 / README < prev    next >
Encoding:
Text File  |  1996-01-16  |  2.9 KB  |  63 lines
  1.  
  2.             Cdecl version 2.5
  3.  
  4. Cdecl is a program which will turn English-like phrases such as "declare
  5. foo as array 5 of pointer to function returning int" into C declarations
  6. such as "int (*foo[5])()".  It can also translate the C into the pseudo-
  7. English.  And it handles typecasts, too.  Plus C++.  And in this version
  8. it has command line editing and history with the GNU readline library.
  9.  
  10. The files in this distribution are:
  11.  
  12. cdecl.c        The cdecl source code.
  13. cdlex.l        The lex source for the cdecl lexer.
  14. cdgram.y    The yacc source for the cdecl parser.
  15. cdecl.1        The cdecl man page.
  16. c++decl.1    The c++decl man page (really just cdecl.1).
  17. testset        A script to test the operation of cdecl.
  18. testset++    A script to test the operation of c++decl.
  19. Makefile    The makefile to build and install cdecl.
  20. README        See file README for description of this file.
  21.  
  22. If you have the GNU readline library and its headers in readline/*.h and
  23. termcap then you can install cdecl by "make" followed by "make install".
  24. To compile without readline and termcap, you must edit the Makefile and
  25. remove -DUSE_READLINE from the CFLAGS and -lreadline and -ltermcap from
  26. the LIBS.  You will, unfortunately, lose the command line editing,
  27. history, and keyword completion.  By default cdecl installs in /usr/bin,
  28. but this is configurable in the Makefile.
  29.  
  30. I debated with myself whether to provide a precompiled libreadline.a and
  31. associated headers with the cdecl distribution, however that would have
  32. made the tar file *much* bigger, so I have decided not to.  If you think
  33. I should, or you would like me to send you readline, please get in touch
  34. with me at conrad@detroit.freenet.org.  You can find the source for
  35. readline in the bash distribution on prep.ai.mit.edu:/pub/gnu or on
  36. ftp.uu.net:/pub/gnu, or wherever fine GNU source isn't sold.
  37.  
  38. You should also be able to find a ready-to-run ELF binary of cdecl in the
  39. same place you got this from.  It should be on sunsite.unc.edu in the
  40. directory /pub/Linux/devel/lang/c/, or on any of the many sunsite mirrors.
  41. My three favorites are ftp.cc.gatech.edu, ftp.cdrom.com, and
  42. uiarchive.cso.uiuc.edu.
  43.  
  44. You may well be wondering what the status of cdecl is.  So am I.  It was
  45. twice posted to comp.sources.unix, but neither edition carried any mention
  46. of copyright.  This version is derived from the second edition.  I have
  47. no reason to believe there are any limitations on its use, and strongly
  48. believe it to be in the Public Domain.  GNU readline is, of course,
  49. covered by the GNU General Public License.
  50.  
  51. I was inspired to port cdecl to Linux as there was no version of it
  52. available in the various Linux software archives that I am aware of.
  53. The addition of GNU readline support seemed like a logical extension
  54. of the program.  Be warned, however, that linking with readline more
  55. than doubles the size of the program.  Those whose main concern is
  56. space might wish to build a version without readline.
  57.  
  58. David R. Conrad
  59. conrad@detroit.freenet.org
  60. Detroit, Michigan, USA
  61. 16 January 1996
  62.  
  63.